23.3 Seiteneinstellungen mit »PageSettings«
Mit einem Objekt vom Typ PageSettings werden die Eigenschaften der jeweils zum Druck anstehenden Seite beschrieben. Wir brauchen kein Objekt dieses Typs erzeugen, obwohl das auch möglich wäre, denn wir erhalten anderweitig die Möglichkeit, darauf zuzugreifen:
|
über die Eigenschaft DefaultPageSettings des PrintDocument-Objekts (hier werden die Standardeinstellungen für alle zu druckenden Seiten festgelegt) |
|
|
über die Eigenschaft PageSettings des QueryPageSettingsEventArgs-Objekts des QueryPageSettings-Ereignisses |
|
|
über die Eigenschaft PageSettings des PrintPageEventArgs-Objekts des PrintPage-Ereignisses |
Da ein PageSettings-Objekt auch mit einem Drucker verbunden ist, der seine Informationen aus diesem Objekt bezieht, erhalten wir auch noch den Zugriff über die Eigenschaft DefaultPageSettings der druckerbeschreibenden PrinterSettings-Objekts. Aber das war bisher noch nicht Thema und soll daher auch an dieser Stelle nur beiläufig erwähnt bleiben.
Ein PageSettings-Objekt verfügt über elf Eigenschaften, die Sie der Tabelle 23.6 entnehmen können.
Tabelle 23.6 Die Eigenschaften eines »PageSettings«-Objekts
| Eigenschaft
|
Beschreibung
|
| Bounds
|
Ruft die Größe der Seite unter Berücksichtigung von Landscape ab. Die Eigenschaft ist schreibgeschützt.
|
| Color
|
Legt fest, ob die Seite in Farbe gedruckt werden soll (falls der Drucker den Farbdruck unterstützt).
|
| HardMarginX
|
Ruft den Abstand zum druckerspezifischen Abstand zum linken Rand in 1/100 Zoll ab.
|
| HardMarginY
|
Ruft den Abstand zum druckerspezifischen Abstand zum oberen Rand in 1/100 Zoll ab.
|
| Landscape
|
Legt fest, ob die Seite im Hoch- oder Querformat gedruckt werden soll.
|
| Margins
|
Legt die Seitenränder für die Seite fest.
|
| PaperSize
|
Ruft die Papiergröße für diese Seite ab oder legt diese fest.
|
| PaperSource
|
Ruft die Papierzufuhr für die Seite ab oder legt diese fest.
|
| PrintableArea
|
Ruft die Abmessungen des druckerspezifischen Druckbereichs ab.
|
| PrinterResolution
|
Gibt die Druckerauflösung für die Seite an oder ruft diese ab.
|
| PrinterSettings
|
Ruft die Druckereinstellungen für die Seite ab oder legt diese fest.
|
Die Einstellung der Eigenschaft Landscape ist true, wenn die Seite im Querformat gedruckt werden soll, ansonsten false. Einen Standardwert gibt es nicht, denn der wird durch den Drucker bestimmt.
Die Eigenschaften PrinterResolution, PaperSource und PaperSize liefern jeweils die Referenz auf ein gleichnamiges Objekt. Hier darauf näher einzugehen würde zu weit führen, und deshalb verweise ich nur auf die .NET-Dokumentation.
Die meisten Eigenschaften des PageSettings-Objekts haben nur informativen Charakter. Die Eigenschaft Margins dürfte vermutlich die Eigenschaft sein, die Sie am häufigsten benutzen werden, denn sie liefert die Standardseitenränder zurück.
| public Margins Margins{get; set;}
|
Die Klasse Margins definiert nur vier eigene Eigenschaften: Left, Right, Top und Bottom. Die Eigenschaften sind ebenfalls auf 1/100-Zoll-Einheiten festgelegt. Wir müssen deshalb den von uns vorgesehenen Rand in Zentimeter passend in das von den vier Eigenschaften interpretierte Maßsystem umrechnen. Soll der Rand 1,5 cm betragen, würde die Wertübergabe wie folgt lauten:
| Margin.Left = (int)(1.5 / 0.0254);
|
|
